home *** CD-ROM | disk | FTP | other *** search
/ Hand Picked Software / Hand Picked Software.iso / aids / ar110 / ar.doc < prev    next >
Text File  |  1995-03-13  |  5KB  |  154 lines
  1.                                  AR
  2.                              version 1.1
  3.  
  4.                       Written by    Haruhiko Okumura
  5.                      Modified by    Terran Melconian
  6.  
  7. 1.0  WHY AR
  8. 2.0  USAGE
  9.     2.1  Add
  10.     2.2  Extract
  11.     2.3  Replace
  12.     2.4  Delete
  13.     2.5  Print
  14.     2.6  List
  15. 3.0  PROGRAMMING
  16.  
  17.  
  18. ---------------------------------------------------------------------
  19.  
  20.  
  21. 1.0  WHY AR
  22.  
  23. Why should you use AR?
  24.  
  25.   * AR is not copyrighted and can be distributed with your software
  26.  
  27.   * Complete source code is included
  28.  
  29.   * Compression is comparable with that of the major archivers such as ZIP,
  30.      ARJ, and LHA.  Look at the following results:
  31.  
  32.     COMMAND  ZIP    31854  (PKZIP)
  33.     COMMAND  ARJ    31902  (ARJ)
  34.     COMMAND  SQZ    32023  (SQZ)
  35.     COMMAND  LZH    32130  (LHA)
  36. **  COMMAND  AR     32140  (AR)         **
  37.     COMMAND  PAK    33578  (PAK)
  38.     COMMAND  COM    34273  (PKLITE)
  39.     COMMAND  CO_    38208  (COMPRESS)
  40.     COMMAND  ARC    40945  (PKPAK)
  41.     COMMAND  ZOO    41805  (ZOO)
  42.     COMMAND  COM    52925  (NONE)
  43.  
  44.     DATA     SQZ    33371  (SQZ)
  45.     DATA     ZIP    33483  (PKZIP)
  46.     DATA     ARJ    33953  (ARJ)
  47.     DATA     LZH    35963  (LHA)
  48. **  DATA     AR     35963  (AR)         **
  49.     DATA     PAK    37239  (PAK)
  50.     DATA     ARC    45259  (PKPAK)
  51.     DATA     ZOO    45833  (ZOO)
  52.     DATA     TX_    46939  (COMPRESS)
  53.     DATA     TXT    97372  (NONE)
  54.  
  55.     MULT     SQZ    78033  (SQZ)
  56. **  MULT     AR     79290  (AR)         **
  57.     MULT     LZH    79293  (LHA)
  58.     MULT     ARJ    80784  (ARJ)
  59.     MULT     ZIP    84985  (PKZIP)
  60.     MULT     PAK    96190  (PAK)
  61.     MULT     ARC   120333  (PKPAK)
  62.     MULT     ZOO   125598  (ZOO)
  63.     MULT           246816  (TOTAL SIZE 105 FILES)
  64.  
  65.  
  66.   * Lousy documentation, but the program itself it good!
  67.  
  68. 2.1  ADD
  69.  
  70.     The ADD command allows you to add files to an existing AR archive or to
  71. create a new archive.  The syntax is:
  72.  
  73. AR A <arfile> <file> [<file>...]
  74.  
  75. where <file> is the files you want to add.  Note that if you try to add a
  76. files which is already in the archive the file will be updated, not added
  77. again.  If you wish to preserve both versions of the file, you must use a
  78. different name.
  79.  
  80. 2.2  EXTRACT
  81.  
  82.     There are two extract options, E and X.  The syntax for them is
  83.  
  84. AR [E/X] <arfile>
  85.  
  86. X will extract the files in the archive to the directory from which they
  87. were stored.  E will extract all files in the archive to the current
  88. directory, regardless of whether they came from different directories
  89. originally.
  90.  
  91. 2.3  REPLACE
  92.  
  93.     Use Replace when you wish to update files in the archive.  If you
  94. specify a file with the R option which is not already in the file, nothing
  95. will happen, so you can add new versions of all the files currently in an
  96. archive by specifying *.* for the file specification.  The full syntax is:
  97.  
  98. AR R <arfile> <file> [<file>...]
  99.  
  100.  
  101. 2.4  DELETE
  102.  
  103.     This option will remove files from an AR archive.  The syntax is:
  104.  
  105. AR D <arfile> <file> [<file>...]
  106.  
  107.  
  108. 2.5  PRINT
  109.  
  110.     This option will print the contents of an AR archive to the screen.  It
  111. can be redirected with the > operators.  The syntax is:
  112.  
  113. AR P <arfile> [<file>...]
  114.  
  115. The default is all files.
  116.  
  117. 2.6  LIST
  118.  
  119.     This option will give a list of all the files stored in an AR archive.
  120. The syntax is:
  121.  
  122. AR L <arfile> [<file>...]
  123.  
  124. The default is all files.
  125.  
  126. 3.0  PROGRAMMING
  127.  
  128.     The complete C source for AR is provided.  For the files which I have
  129. modified, I have included the original with a .BAK extention.  If you find
  130. some bugs, just fix 'em and distribute a new version with your name on the
  131. list of people who made modifications.  I don't think there are any bugs at
  132. the present but I did not do extensive testing.
  133.  
  134. ---------------------------------------------------------------------
  135.  
  136.                                  SUMMARY:
  137.  
  138.  
  139. ar -- compression archiver -- written by Haruhiko Okumura
  140.                         modifications by Terran Melconian
  141. Usage: ar command archive [file ...]
  142. Commands:
  143.    a: Add files to archive (replace if present)
  144.    e: Extract files from archive
  145.    x: Extract files with path
  146.    r: Replace files in archive
  147.    d: Delete files from archive
  148.    p: Print files on standard output
  149.    l: List contents of archive
  150. If no files are named, all files in archive are processed,
  151.    except for commands 'a' and 'd'
  152. You may copy, distribute, and rewrite this program freely.
  153.  
  154.